The VERSIONINFO resource contains such information about the file as its version number, its intended operating system, and its original filename. The resource is intended to be used with the File Installation library functions.

Syntax

versionID VERSIONINFO fixed-info
   BEGIN
      block-statement
      . . .
   END

Parameters

versionID

Specifies the version-information resource identifier. This value must be 1.

fixed-info

Specifies the version information, such as the file version and the intended operating system.

block-statement

Specifies one or more version-information blocks. A block can contain string information or variable information.

langID

Specifies one of the following language codes:

charsetID

Specifies one of the following character-set identifiers:

string-name

Specifies one of the following redefined names:

Comments

Specifies additional information that should be displayed for diagnostic purposes.

CompanyName

Specifies the company that produced the file, for example, ”Microsoft Corporation”. This string is required.

FileDescription

Specifies a file description to be presented to users. This string may be displayed in a list box when the user is choosing files to install, for example, "Microsoft Word for Windows”. This string is required.

FileVersion

Specifies the version number of the file, for example, ”5.10” or ”3.00.RC1”. This string is required.

InternalName

Specifies the internal name of the file, if one exists, for example, a module name if the file is a dynamic-link library. If the file has no internal name, this string should be the original filename, without extension. This string is required.

LegalCopyright

Specifies all copyright notices that apply to the file. This should include the full text of all notices, legal symbols, copyright dates, and so on, for example, ”Copyright© Microsoft Corporation 1990-2002”. This string is optional.

LegalTrademarks

Specifies all trademarks and registered trademarks that apply to the file. This should include the full text of all notices, legal symbols, trademark numbers, and so on, for example, ”Windows™ is a trademark of Microsoft® Corporation”. This string is optional.

OriginalFilename

Specifies the original name of the file, not including a path. This information enables an application to determine whether a file has been renamed by a user. The format of the name depends on the file system for which the file was created. This string is required.

PrivateBuild

Specifies information about a private version of the file, for example, ”Built by TESTER1 on \TESTBED”. This string should be present only if the VS_FF_PRIVATEBUILD flag is set in the dwFileFlags member of the VS_FIXEDFILEINFO structure of the root block.

ProductName

Specifies the name of the product with which the file is distributed, for example, ”Microsoft Windows”. This string is required.

ProductVersion

Specifies the version of the product with which the file is distributed, for example, ”5.10” or ”3.00.RC1”. This string is required.

SpecialBuild

Specifies how this version of the file differs from the standard version¾for example, ”Private build for TESTER1 solving mouse problems on M250 and M250E computers”. This string should be present only if the VS_FF_SPECIALBUILD flag is set in the dwFileFlags member of the VS_FIXEDFILEINFO structure in the root block.

A string information block has the following form:

BLOCK "StringFileInfo"
   BEGIN
      BLOCK "lang-charset"
      BEGIN
          VALUE "string-name", "value"
          . . .
      END
   END

Following are the parameters in the StringFileInfo block:

lang-charset

Specifies a language and character-set identifier pair. It is a hexadecimal string consisting of the concatenation of the language and character-set identifiers listed earlier in this section.

string-name

Specifies the name of a value in the block and can be one of the redefined names listed earlier in this section.

value

Specifies, as a character string, the value of the corresponding string name. More than one VALUE statement can be given.

A variable information block has the following form:

BLOCK "VarFileInfo"
   BEGIN
      VALUE "Translation",
           langID, charsetID
           . . .
   END

Following are the parameters in the variable information block:

langID

Specifies one of the language identifiers listed earlier in this section.

charsetID

Specifies one of the character-set identifiers listed earlier in this section. More than one identifier pair can be given, but each pair must be separated from the preceding pair with a comma.